number of ticks (1/60ths of a second) to wait, or zero
character the message must start with to be OK (not error)
maximum number of characters to be accepts
-- part contents for background part 4
----- text -----
This XCMD is intended to read messages from the SMTP, NNTP, and POP protocols. Most messages start with a line indicating success or failure. The first character of this first line is sufficient to disambiguate success and failure returns. For SMTP and NNTP, the initial success character is "2" (first digit of a number). For POP, the first character is "+". The okChar parameter tells the XCMD what initial character should be present for "success;" any other character is considered a
"failure." In some other cases there is no initial success/failure line. For these types of messages, okChar should be empty. In either case, the message body is a series of text lines, terminated with a period on a line by itself. Any other lines which start with period, have a second period inserted at the start.
This XCMD also does some appropriate filtering: it removes linefeeds and nulls, it removes control-Hs and the character immediately before it, it takes out the second period inserted by the sender on lines that start with a period, and it converts tabs to spaces.
For failed messages (which do not start with the okChar and if okChar is not empty), it returns the the line surrounded by
"•••"s. This makes it fairly easy to check for error conditions.
If the space limit is reached, the message is still received up to the end, but only the first limit characters are kept, and the string "••• message too big •••" is appended to the end.
